home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / X11 / xfontsel.z / xfontsel
Text File  |  1998-10-30  |  14KB  |  265 lines
  1.  
  2.  
  3.  
  4.      XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))          XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           xfontsel - point & click interface for selecting X11 font
  10.           names
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           xxxxffffoooonnnnttttsssseeeellll [-_t_o_o_l_k_i_t_o_p_t_i_o_n ...]  [----ppppaaaatttttttteeeerrrrnnnn _f_o_n_t_n_a_m_e]]]] [[[[----pppprrrriiiinnnntttt]]]]
  14.           [[[[----ssssaaaammmmpppplllleeee _t_e_x_t]]]] [[[[----ssssaaaammmmpppplllleeee11116666 _t_e_x_t_1_6]]]] [[[[----nnnnoooossssccccaaaalllleeeedddd]]]]
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.           The _x_f_o_n_t_s_e_l application provides a simple way to display
  18.           the fonts known to your X server, examine samples of each,
  19.           and retrieve the X Logical Font Description ("XLFD") full
  20.           name for a font.
  21.  
  22.           If ----ppppaaaatttttttteeeerrrrnnnn is not specified, all fonts with XLFD 14-part
  23.           names will be selectable.  To work with only a subset of the
  24.           fonts, specify ----ppppaaaatttttttteeeerrrrnnnn followed by a partially or fully
  25.           qualified font name; e.g., ``-pattern *medium*'' will select
  26.           that subset of fonts which contain the string ``medium''
  27.           somewhere in their font name.  Be careful about escaping
  28.           wildcard characters in your shell.
  29.  
  30.           If ----pppprrrriiiinnnntttt is specified on the command line the selected font
  31.           specifier will be written to standard output when the _q_u_i_t
  32.           button is activated.  Regardless of whether or not ----pppprrrriiiinnnntttt
  33.           was specified, the font specifier may be made the PRIMARY
  34.           (text) selection by activating the _s_e_l_e_c_t button.
  35.  
  36.           The ----ssssaaaammmmpppplllleeee option specifies the sample text to be used to
  37.           display the selected font if the font is linearly indexed,
  38.           overriding the default.
  39.  
  40.           The ----ssssaaaammmmpppplllleeee11116666 option specifies the sample text to be used to
  41.           display the selected font if the font is matrix encoded,
  42.           overriding the default.
  43.  
  44.           The ----nnnnoooossssccccaaaalllleeeedddd option disables the ability to select scaled
  45.           fonts at arbitrary pixel or point sizes.  This makes it
  46.           clear which bitmap sizes are advertised by the server, and
  47.           can avoid an accidental and sometimes prolonged wait for a
  48.           font to be scaled.
  49.  
  50.      IIIINNNNTTTTEEEERRRRAAAACCCCTTTTIIIIOOOONNNNSSSS
  51.           Clicking any pointer button in one of the XLFD field names
  52.           will pop up a menu of the currently-known possibilities for
  53.           that field.  If previous choices of other fields were made,
  54.           only values for fonts which matched the previously selected
  55.           fields will be selectable; to make other values selectable,
  56.           you must deselect some other field(s) by choosing the ``*''
  57.           entry in that field.  Unselectable values may be omitted
  58.           from the menu entirely as a configuration option; see the
  59.           SSSShhhhoooowwwwUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeee resource, below.  Whenever any change is
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))          XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))
  71.  
  72.  
  73.  
  74.           made to a field value, _x_f_o_n_t_s_e_l will assert ownership of the
  75.           PRIMARY_FONT selection.  Other applications (see, e.g.,
  76.           _x_t_e_r_m) may then retrieve the selected font specification.
  77.  
  78.           Scalable fonts come back from the server with zero for the
  79.           pixel size, point size, and average width fields.  Selecting
  80.           a font name with a zero in these positions results in an
  81.           implementation-dependent size.  Any pixel or point size can
  82.           be selected to scale the font to a particular size.  Any
  83.           average width can be selected to anamorphically scale the
  84.           font (although you may find this challenging given the size
  85.           of the average width menu).
  86.  
  87.           Clicking the left pointer button in the _s_e_l_e_c_t widget will
  88.           cause the currently selected font name to become the PRIMARY
  89.           text selection as well as the PRIMARY_FONT selection.  This
  90.           then allows you to paste the string into other applications.
  91.           The sssseeeelllleeeecccctttt button remains highlighted to remind you of this
  92.           fact, and de-highlights when some other application takes
  93.           the PRIMARY selection away.  The _s_e_l_e_c_t widget is a toggle;
  94.           pressing it when it is highlighted will cause _x_f_o_n_t_s_e_l to
  95.           release the selection ownership and de-highlight the widget.
  96.           Activating the _s_e_l_e_c_t widget twice is the only way to cause
  97.           _x_f_o_n_t_s_e_l to release the PRIMARY_FONT selection.
  98.  
  99.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  100.           The application class is XXXXFFFFoooonnnnttttSSSSeeeellll.  Most of the user-
  101.           interface is configured in the app-defaults file; if this
  102.           file is missing a warning message will be printed to
  103.           standard output and the resulting window will be nearly
  104.           incomprehensible.
  105.  
  106.           Most of the significant parts of the widget hierarchy are
  107.           documented in the app-defaults file (normally
  108.           /usr/lib/X11/app-defaults/XFontSel).
  109.  
  110.           Application specific resources:
  111.  
  112.           ccccuuuurrrrssssoooorrrr ((((class CCCCuuuurrrrssssoooorrrr))))
  113.                   Specifies the cursor for the application window.
  114.  
  115.           ppppaaaatttttttteeeerrrrnnnn ((((class PPPPaaaatttttttteeeerrrrnnnn))))
  116.                   Specifies the font name pattern for selecting a
  117.                   subset of available fonts.  Equivalent to the
  118.                   ----ppppaaaatttttttteeeerrrrnnnn option.  Most useful patterns will contain
  119.                   at least one field delimiter; e.g. ``*-m-*'' for
  120.                   monospaced fonts.
  121.  
  122.           ppppiiiixxxxeeeellllSSSSiiiizzzzeeeeLLLLiiiisssstttt ((((class PPPPiiiixxxxeeeellllSSSSiiiizzzzeeeeLLLLiiiisssstttt))))
  123.                   Specifies a list of pixel sizes to add to the pixel
  124.                   size menu, so that scalable fonts can be selected at
  125.                   those pixel sizes.  The default pixelSizeList
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))          XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))
  137.  
  138.  
  139.  
  140.                   contains 7, 30, 40, 50, and 60.
  141.  
  142.           ppppooooiiiinnnnttttSSSSiiiizzzzeeeeLLLLiiiisssstttt ((((class PPPPooooiiiinnnnttttSSSSiiiizzzzeeeeLLLLiiiisssstttt))))
  143.                   Specifies a list of point sizes (in units of tenths
  144.                   of points) to add to the point size menu, so that
  145.                   scalable fonts can be selected at those point sizes.
  146.                   The default pointSizeList contains 250, 300, 350,
  147.                   and 400.
  148.  
  149.           pppprrrriiiinnnnttttOOOOnnnnQQQQuuuuiiiitttt ((((class PPPPrrrriiiinnnnttttOOOOnnnnQQQQuuuuiiiitttt))))
  150.                   If _T_r_u_e the currently selected font name is printed
  151.                   to standard output when the quit button is
  152.                   activated.  Equivalent to the ----pppprrrriiiinnnntttt option.
  153.  
  154.           ssssaaaammmmpppplllleeeeTTTTeeeexxxxtttt ((((class TTTTeeeexxxxtttt))))
  155.                   The sample 1-byte text to use for linearly indexed
  156.                   fonts.  Each glyph index is a single byte, with
  157.                   newline separating lines.
  158.  
  159.           ssssaaaammmmpppplllleeeeTTTTeeeexxxxtttt11116666 ((((class TTTTeeeexxxxtttt11116666))))
  160.                   The sample 2-byte text to use for matrix-encoded
  161.                   fonts.  Each glyph index is two bytes, with a 1-byte
  162.                   newline separating lines.
  163.  
  164.           ssssccccaaaalllleeeeddddFFFFoooonnnnttttssss ((((class SSSSccccaaaalllleeeeddddFFFFoooonnnnttttssss))))
  165.                   If _T_r_u_e then selection of arbitrary pixel and point
  166.                   sizes for scalable fonts is enabled.
  167.  
  168.           Widget specific resources:
  169.  
  170.           sssshhhhoooowwwwUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeee ((((class SSSShhhhoooowwwwUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeee))))
  171.                   Specifies, for each field menu, whether or not to
  172.                   show values that are not currently selectable, based
  173.                   upon previous field selections.  If shown, the
  174.                   unselectable values are clearly identified as such
  175.                   and do not highlight when the pointer is moved down
  176.                   the menu.  The full name of this resource is
  177.                   ffffiiiieeeellllddddNNNN....mmmmeeeennnnuuuu....ooooppppttttiiiioooonnnnssss....sssshhhhoooowwwwUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeee, class
  178.                   MMMMeeeennnnuuuuBBBBuuuuttttttttoooonnnn....SSSSiiiimmmmpppplllleeeeMMMMeeeennnnuuuu....OOOOppppttttiiiioooonnnnssss....SSSShhhhoooowwwwUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeee;
  179.                   where N is replaced with the field number (starting
  180.                   with the left-most field numbered 0).  The default
  181.                   is True for all but field 11 (average width of
  182.                   characters in font) and False for field 11.  If you
  183.                   never want to see unselectable entries,
  184.                   '*menu.options.showUnselectable:False' is a
  185.                   reasonable thing to specify in a resource file.
  186.  
  187.      FFFFIIIILLLLEEEESSSS
  188.            $XFILESEARCHPATH/XFontSel
  189.  
  190.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  191.           xrdb(1), xfd(1)
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555))))          XXXXFFFFOOOONNNNTTTTSSSSEEEELLLL((((1111))))
  203.  
  204.  
  205.  
  206.      BBBBUUUUGGGGSSSS
  207.           Sufficiently ambiguous patterns can be misinterpreted and
  208.           lead to an initial selection string which may not correspond
  209.           to what the user intended and which may cause the initial
  210.           sample text output to fail to match the proffered string.
  211.           Selecting any new field value will correct the sample
  212.           output, though possibly resulting in no matching font.
  213.  
  214.           Should be able to return a FONT for the PRIMARY selection,
  215.           not just a STRING.
  216.  
  217.           Any change in a field value will cause _x_f_o_n_t_s_e_l to assert
  218.           ownership of the PRIMARY_FONT selection.  Perhaps this
  219.           should be parameterized.
  220.  
  221.           When running on a slow machine, it is possible for the user
  222.           to request a field menu before the font names have been
  223.           completely parsed.  An error message indicating a missing
  224.           menu is printed to stderr but otherwise nothing bad (or
  225.           good) happens.
  226.  
  227.           The average-width menu is too large to be useful.
  228.  
  229.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  230.           Copyright 1989, 1991 by the Massachusetts Institute of
  231.           Technology
  232.           See _X(_1) for a full statement of rights and permissions.
  233.  
  234.      AAAAUUUUTTTTHHHHOOOORRRR
  235.           Ralph R. Swick, Digital Equipment Corporation/MIT Project
  236.           Athena
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.